home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / stdump.z / stdump
Text File  |  1998-10-30  |  5KB  |  133 lines
  1.  
  2.  
  3.  
  4. SSSSTTTTDDDDUUUUMMMMPPPP((((1111))))                                                            SSSSTTTTDDDDUUUUMMMMPPPP((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      stdump - dump a file of intermediate-code debugging information
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ssssttttdddduuuummmmpppp [-a] [-b] [-c]  [-g] [-h] [-i]  [-n number] _f_i_l_e
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      When compiling for the old 32-bit ABI (-32), the compilers generate an
  16.      intermediate language which is separated into binary instructions and
  17.      debugging information, each constituting a separate file.  Use _s_t_d_u_m_p to
  18.      dump a file containing debugging information which was generated by the
  19.      compilers.  _s_t_d_u_m_p writes to the standard output. The organization of the
  20.      output is simple but the details of the output are complicated.  The
  21.      detailed output is be defined here. The output of _s_t_d_u_m_p is subject to
  22.      change and one should not rely on the output format remaining the same
  23.      from release to release.
  24.  
  25.      The organization of the output is:  for each source file represented in
  26.      _f_i_l_e there may be auxiliary-symbols, local-symbols, a file-indirect-
  27.      table, optimization-entries, procedures, and line-numbers; there is only
  28.      one externals-table and one dense-number-table in _f_i_l_e.
  29.  
  30.      By default, _s_t_d_u_m_p prints all information about all sections of the
  31.      debugging information.  The options (described below) restrict the output
  32.      to the selected sections.
  33.  
  34.      The _f_i_l_e may be an object file (such as produced by cc -c) or an
  35.      executable file (such as produced by _l_d(_1) or _c_c(1)) or a debugging
  36.      information file (which may be produced as described below).
  37.  
  38.      Normally, debugging information files (and instruction files) are placed
  39.      in /tmp and removed after each compilation.  Use the ----kkkkeeeeeeeepppp option to _c_c,
  40.      or _f_7_7(1) to force the compiler to preserve these files in the target
  41.      directory.  When this switch is used, the compilation of ffffiiiilllleeee...._x (where _x
  42.      is c for C or f for FORTRAN, for example) will produce the intermediate
  43.      files ffffiiiilllleeee...._B (instructions) and ffffiiiilllleeee...._T (debugging information).  The
  44.      latter file (ffffiiiilllleeee...._T) may be used as input to _s_t_d_u_m_p.
  45.  
  46.      The following options are recognized:
  47.  
  48.      ----aaaa      Print the dense number table.  This section is empty for object
  49.              and executable files.
  50.  
  51.      ----bbbb      Print the externals table.
  52.  
  53.      ----cccc      Print the local debugging symbols.  The source file name is
  54.              printed here.
  55.  
  56.      ----gggg      Print the auxiliaries table.  This table has encoded in it in a
  57.              complex way the actual data types of all the data in the symbols.
  58.              The local-symbol and externals table sections show this data
  59.              expanded into semi-readable text.
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. SSSSTTTTDDDDUUUUMMMMPPPP((((1111))))                                                            SSSSTTTTDDDDUUUUMMMMPPPP((((1111))))
  71.  
  72.  
  73.  
  74.      ----hhhh      Print the line table.  One source line number per 32-bits of
  75.              executable code.
  76.  
  77.      ----iiii      Print the File Indirect Table.
  78.  
  79.      ----nnnn nnnnuuuummmmbbbbeeeerrrr
  80.              Print information about only the source file whose number is
  81.              given.  Files are numbered sequentially starting with zero.
  82.  
  83. FFFFIIIILLLLEEEESSSS
  84.      /tmp/ctmsta_x_x_x_x_x default name of debugging information file for process
  85.                       id _x_x_x_x_x
  86.  
  87.      _f_i_l_e.T           name of debugging information file created by the ----kkkkeeeeeeeepppp
  88.                       option
  89.  
  90.      /usr/bin/stdump  debugging information dump program
  91.  
  92. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  93.      elfdump(1), dwarfdump(1), cc(1), f77(1), pc(1), abi(5)
  94.  
  95. NNNNOOOOTTTTEEEESSSS
  96.      One cannot use stdump to display the debugging information of 64-bit  (-
  97.      64) or new 32bit ABI (-n32) object files. Use dwarfdump(1) instead.
  98.  
  99.      To see the linking information, use _e_l_f_d_u_m_p(1) instead of _s_t_d_u_m_p.
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.